Description

Triggers the task at the date, time or interval specified.

Practical Usage

The Schedule Watcher trigger is the most commonly used trigger. It can be used for scheduling tasks to run at night or at the end of every day, week, month or other time frame -- such as running reports, database backups and other routine work.

Parameters

General Tab

Interval

Specifies the time based interval on which the schedule will be based. If the task should run every day, select days, the task should run monthly - select months.

The available options are:

days: The task will run once every X number of days. Except days or times matching exclusions specified in the Exclude tab.

hours: The task will run once every X number of hours. Except days or times matching exclusions specified in the Exclude tab.

minutes: The task will run once every X number of minutes. Except days or times matching exclusions specified in the Exclude tab.

seconds: The task will run once every X number of seconds. Except days or times matching exclusions specified in the Exclude tab.

specific days of the week: The task will run once or more per X number of weeks on the days specified. Use this option is a task should run Monday through Friday only. Except days or times matching exclusions specified in the Exclude tab.

specific days of the month: The task will run once or more per X number of months on the days specified. Use this option is a task should run at the end of the month regardless of the actual numeric date. Selecting this option reveals several other useful options for specifying when the task should run. Except days or times matching exclusions specified in the Exclude tab.

custom schedule: The task will run only on the custom dates and times specified. Use this option if there is no regular interval for the task to automatically reschedule on. Except days or times matching exclusions specified in the Exclude tab.

Return Value

When this trigger is activated - it automatically passes the AMTrigger object to the task.

The following properties are populated:

AMTrigger.Trigger

String

The name of the trigger that started the task.  For this trigger, the value is always "AMSCHEDULETRIGGER".

AMTrigger.TaskLate

Boolean

Specifies to the task whether the schedule trigger launched past it's next launch date time. This can occur if the computer was off or the AutoMate Task Service was not running or was disabled when the task was scheduled to run.